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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

x the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 

The present document is part of a TS-family covering the 3rd Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; Test management Integration Reference Point 
(IRP), as identified below: 

32.321 : "Test management Integration Reference Point (IRP); Requirements" ; 

32.322: "Test management Integration Reference Point (IRP): Information Service (IS)"; 

32.323: "Test management Integration Reference Point (IRP): Common Object Request Broker 

Architecture (CORBA) Solution Set (SS)"; 

32.324: "Test management Integration Reference Point (IRP): Common Management Information Protocol 

(CMIP) Solution Set (SS)". 

A 3G telecommunication network is composed of a multitude of different Network Elements (NE). For a successful 
operation of the network the operator must be provided with mechanisms allowing him to manage the network. These 
management activities can be grouped into several areas: configuration management, fault management, performance 
management, accounting management and security management. 

A management function assisting in different high level management areas such as fault management and performance 
management is test management. The purpose of testing is to get information about the functionality and performance 
of the 3G managed network subject to the test. 

The present document is part of a TS-family defining the Telecommunication Management (TM) of 3G systems. 
The TM principles are described in 3GPP TS 32.101 [5]. The TM architecture is described in 3GPP TS 32.102 [6]. 
The other specifications define the interface (Itf-N) between the managing system (manager), which is in general the 
Network Manager (NM) and the managed system (agent), which is either an Element Manager (EM) or the managed 
NE itself. The Itf-N is composed of a number of integration reference points (IRPs) defining the information in the 
agent that is visible for the manager, the operations that the manager may perform on this information and the 
notifications that are sent from the agent to the manager. One of these IRPs is the Test Management IRP. 

Each IRP is specified by the requirements part, the IS part, the CORBA SS and the CMIP SS. 
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1 Scope 



The present document defines the IS part of the Test Management IRP, which describes the semantics of the 
information and the interactions visible across Itf-N in a protocol independent way. The information is specified by 
means of information object classes and the interactions by means of operations and notifications. The present 
document does not specify the syntax (encoding) of the information. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[I] 3GPP TS 32.302: "Telecommunication management; Configuration Management (CM); 
Notification Integration Reference Point (IRP): Information Service (IS)". 

[2] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Information Service (IS)". 

[3] 3GPP TS 32.622: "Telecommunication management; Configuration Management (CM); Generic 

network resources Integration Reference Point (IRP): Network Resource Model (NRM)". 

[4] ITU-T Recommendation X.733: "Information technology - Open Systems Interconnection - 

Systems Management: Alarm reporting function" . 

[5] ITU-T Recommendation X.745: "Information technology - Open Systems Interconnection - 

Systems Management: Test management function" . 

[6] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[7] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[8] 3GPP TS 32.321: "Telecommunication management; Test management Integration Reference 

Point (IRP): Requirements". 

[9] 3GPP TS 32.672: "Telecommunication management; Configuration Management (CM); State 

Management Integration Reference Point (IRP): Information Service (IS)". 

[10] ITU-T Recommendation X.737: "Information technology - Open Systems Interconnection - 

Systems Management: Confidence and diagnostic test categories. 

[II] 3GPP TS 32.150: "Telecommunication management; Integration Reference Point (IRP) Concept 
and definitions". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 32.101 [6], 3GPP TS 32.102 [7] 
and 3GPP TS 32.321 [8] apply. 
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3.2 



Abbreviations 



For the purposes of the present document, the following abbreviations apply: 

EM Element Manager 

IOC Information Object Class 

IRP Integration Reference Point 

IS Information Service 

ME Element Manager 

MORT Managed Object Referring to Test 

NE Network Element 

TM Telecommunication Management 

TO Tester Object 

VSE Vendor-Specific-Extended 

VSE TO Vendor-Specific-Extended Tester Object 



4 System Overview 

4.1 System Context 

The general definition of the System Context for the present IRP is found in 3GPP TS 32.150 [11] subclause 4.7. 
In addition, the set of related IRP(s) relevant to the present IRP is shown in the two diagrams below. 




Itf-N 



IRPAgent 



-EM 



NEs 




Test Management IRP 
Notification IRP 



Figure 1 : System Context A 
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IRPAgent 










NE 





Itf-N 



Test Management IRP 
Notification IRP 



Figure 2: System Context B 
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5 Information Object Classes (lOCs) 

5.1 Information Entities imported and local Labels 



Label reference 


Local label 


3GPP TS 32.622 [3], information object class, Top 


Top 


3GPP TS 32.622 [3], information object class, IRPAgent 


IRPAgent 


3GPP TS 32.312 [2], information object class, managedGenericIRP 


managedGenericIRP 
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5.2 Class Diagram 

5.2.1 Attributes and Relationships 

The following figure shows, for the Test Management IRP, the class definitions and the relationships between the 
classes. 



«lnformationObjectClass» 
TestManagementIRP 



«lnformationObjectClass» 
TestActionPerformer 

+ supportedTOCIasses 
+ testActionPerformerld 



theTesterObject 

* 

M/ 

«lnformationObjectClass» 
Teste rObject 

+ testOutcome 
+h t + ok- + +testState 
tne i esteruoject _ testlnvocation Initiator 
-^ - additional Information 

- proposedRepairActions 

- fileReference 

- fileExpiryDate 
+ testerObjectld 



theTestlnvocation 



J^ 



1 



1 
theTestlnvocation 



V 



1 



«lnformationObjectClass» 
Testlnvocation 



+ actualStartTime 

+ actualStopTime 

- maxTestingPhaseDuration 

+ testlnvocationld 



isTesting ^ 



«ProxyClass» 
MORT 



theMORT 



From the cardinalities can be seen that each instance of TestManagementIRP may have several instances of 
TestActionPerformer. Each instance of TestActionPerformer can have multiple instances of associated TesterObjects. 
Each instance of TesterObject in turn has one instance of Testlnvocation and one instance of MORT. 
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5.2.2 Inheritance 

The following figure depicts the inheritance relationships between the information object classes. As can be seen the 
IOC TestManagementIRP inherits from ManagedGenericIRP ', the Proxy Class VSEResourceSelfTestTesterObject 
inherits from the IOC ResourceSeljTestTesterObject which in turn inherits from TesterObject. The Proxy Class 
V SET ester Object inherits from the Proxy Class VSETestCategoryTesterObject which inherits from the IOC 
TesterObject. By default IOCs inherit from the IOC Top. 



«lnformationObjectClass» 
ManagedGenericIRP 



X 



«lnformationObjectClasses» 
TesterObject 



«lnformationObjectClass» 
TestManagementIRP 



«lnformationObjectClass» 
ResourceSelfTestTesterObject 



7T 



«ProxyClass» 
VSETestCategoryTesterObject 



T 



«ProxyClass» 
VSE ResourceSelfTestTesterObject 



«ProxyClass» 
VSETesterObject 



5.3 Information Object Classes (IOCs) definition 
5.3.1 Information Object Class TestManagementIRP 



5.3.1.1 



Definition 



The IOC TestManagementIRP together with the IOC TestActionPerformer represent the test management capabilities 
defined by this specification. To conduct a test of network resources, this object may require capabilities of other 
objects such as TesterObject. The IOC TestManagementIRP inherits from the IOC ManagedGenericIRP specified in 
3GPPTS 32.312 [2]. 

5.3.1.2 Attributes 

The IOC TestManagementIRP has no own attributes, only those inherited from the IOC ManagedGenericIRP. 
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5.3.2 Information Object Class Test Action Performer 



5.3.2.1 



Definition 



The IOC TestActionPerformer provides the ability to receive and react upon test requests. This class must also be able 
to instantiate and delete tester objects or, in case the tester objects are permanently instantiated, to allocate and reserve 
them for their usage. This specification does not require this IOC to be instantiated. It may be abstract and used for 
inheritance purposes only. In this way the ability to receive and react upon test requests may be included in any other 
IOC. 



5.3.2.2 



Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


supportedTOCIasses 


+ 


M 


M 


- 


testActionPerformerld 


+ 


M 
see note 


M 


- 


NOTE: This attribute is only mandatory in case the IOC TestActionPerformer is instantiated. In case this IOC is an 
abstract class and used for inheritance purposes only the attribute shall be omitted. 



5.3.3 Information Object Class TesterObject 



5.3.3.1 



Definition 



The IOC TesterObject monitors and controls the testing of a MORT instance and reports the outcome of the test 
execution. Tester Objects (TOs) are instantiated by the IOC TestActionPerformer in response to a valid test initiation 
request (initiateTests). They are deleted after termination of the test. It is also possible that TOs are permanently 
instantiated. In this case they are allocated to a certain TestActionPerformer during the test execution. After termination 
of the test they are released. 

The IOC TesterObject defines a generic TO. It shall be used as an abstract class from which more specific tester objects 
shall be derived by specialisation for each test category. Test categories and the associated test category specific TOs 
are defined in ITU-T Recommendation X.737 [10]. These test category specific TOs can be specialised further by 
defining Vendor- Specific -Extended (VSE) TOs. The generic TO defines attributes pertaining to a test and required for 
all test categories. 

Each test invocation shall have only one associated TO. 

Only test category specific TOs or VSE TOs shall be instantiated. 

For simplicity this specification will often use only the term TO. In this case either the test category specific TO or the 
VSE TO is referred to depending on which is actually instantiated. 



5.3.3.2 



Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


testOutcome 


+ 


M 


M 


- 


testState 


+ 


M 


M 


- 


testlnvocationlnitiator 


- 


C 


M 


- 


additionallnformation 


- 


O 


- 


- 


proposedRepairActions 


- 


O 


- 


- 


fileReference 


- 


M 
see note 


- 


- 


fileExpiryDate 


- 


M 
see note 


- 


- 


testerObjectld 


+ 


M 


M 


- 


NOTE: In case the TO does support capturing test results in a file this parameter shall be present and contain 

information. In case the TO does not support capturing test results in a file this parameter shall contain no 
information or shall be absent. 
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5.3.4 Information Object Class ResourceSelfTestTesterObject 

5.3.4.1 Definition 

The IOC ResourceSeljTesterObject is a specialised TO for the resource self test. It inherits from the IOC TesterObject. 
It specifies the triggering events for the emission of the test result notifications. 

5.3.4.2 Attributes 

This IOC has no own attributes, only those inherited from the generic IOC TesterObject. 

5.3.5 Proxy Class VSETestCategoryTesterObject 

5.3.5.1 Definition 

Certain tests may not fit in any of the test categories defined in ITU-T Recommendation X.737 [10]. In this case 
vendors may define new (VSE) test categories and the associated test category specific TOs. The Proxy Class 
VSETestCategoryTesterObject represents the set of these VSE test category tester objects 

The IOCs represented by the Proxy Class VSETestCategoryTesterObject shall inherit from the IOC TesterObject. 

NOTE: A vendor may also claim 3GPP compliance to a certain release in case that a specific test fits into one of 
the ITU-T test categories without that the corresponding ITU-T test category specific TO is supported in 
this release supposed that this test category specific TO will be added in a later release than the current 
one. The vendor shall update this specification in due time. 

5.3.5.2 Attributes 

The attributes of this IOC are vendor specific. 

5.3.6 Proxy Class VSEResourceSelfTestTesterObject 

5.3.6.1 Definition 

In case the IOC ResourceSelfTestTesterObject does not fulfil the specific requirements of a certain resource self test, 
vendors may define proprietary IOCs by further specialisation. The Proxy Class VSEResourceSelfTestTesterObject 
represents these IOCs. 

The IOCs represented by the Proxy Class VSEResourceSelfTestTesterObject shall inherit from the IOC 
ResourceSelfTestTesterObject. 

5.3.6.2 Attributes 

Apart from the attributes inherited the attributes of the IOCs represented by this Proxy Class are vendor specific. 



5.3.7 Proxy Class VSETesterObject 



5.3.7.1 Definition 

In case an IOC represented by the Proxy Class VSETestCategoryTesterObject does not fulfil the specific requirements 
of a certain test, vendors may define proprietary IOCs by further specialisation. The Proxy Class VSETesterObject 
represents these IOCs. 

The IOCs represented by the Proxy Class VSETesterObject shall inherit from the associated IOC represented by the 
Proxy Class VSETestCategoryTesterObject. 
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5.3.7.2 Attributes 

Apart from the attributes inherited the attributes of the IOCs represented by this Proxy Class are vendor specific. 

5.3.8 Proxy Class MORT 

5.3.8.1 Definition 

The ProxyClass MORT represents a network resource that is under test. Its class definition shall be one defined in the 
various 3 GPP Network Resource Model specifications or defined by a VSE network resource class. 

5.3.8.2 Attributes 

This IOC has no attributes. 

5.3.9 Information Object Class Test Invocation 

5.3.9.1 Definition 

The IOC Testlnvocation is the abstract representation of a test invocation. A test invocation shall aim to test one or 
more capabilities of a MORT. The IRPManager can request for the establishment of a test invocation using the 
operation initiateTests. 

A MORT can be complex in that there are multiple capabilities that can be subject to test. Therefore, it is possible to 
have multiple test activities active, all aimed at the same MORT but on its different capabilities. Whether multiple test 
activities can be testing the same MORT capabilities at the same time is an implementation decision, probably based on 
the nature and behaviour of the TO, and therefore, is outside the scope of this specification. 

5.3.9.2 Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


actualStartTime 


+ 





M 


- 


actualStopTime 


+ 





M 


- 


maxTestingPhaseDuration 


- 





- 


- 


testlnvocationld 


+ 


M 


M 


- 



5.4 Information relationships definition 

5.4.1 Relationship between TestManagementIRP and 
TestAction Performer 

5.4.1.1 Definition 

This relationship defines a binary association between the IOC TestManagementIRP and the IOC TestActionPerformer. 

5.4.1.2 Roles 

This relationship has no roles. 

5.4.2 Relationship between TestActionPerformer and TesterObject 
5.4.2.1 Definition 

This relationship defines a binary association between the IOC TestActionPerformer and the IOC TesterObject. The 
association is navigable from the TestActionPerformer to the TesterObject. 
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5.4.2.2 



Roles 



Name 



Definition 



theTesterObject 



This rolename provides a name allowing to navigate from an instance of TestAction Performer to the 
associated instances of TesterObject If tap is an instance of TestAction Performert, the expression 
tap. theTesterObject yields the set of object instances of TesterObject 



5.4.3 Relationship between TestAction Performer and Test Invocation 



5.4.3.1 



Definition 



This relationship defines a binary association between the IOC TestActionPerformer and the IOC Testlnvo cation. 
The association is navigable from the TesterObject to the Testlnvo cation. 



5.4.3.2 



Roles 



Name 



Definition 



theTestlnvocation 



This rolename provides a name allowing to navigate from an instance of TestActionPerformer to the 
associated instances of Testlnvocation. If tap is an instance of TestAction Performert, the expression 
tap.theTestlnvocation yields the set of object instances of Testlnvocationt 



5.4.4 Relationship between TesterObject and Testlnvocation 



5.4.4.1 



Definition 



This relationship defines a binary association between the IOC TesterObject and the IOC Testlnvocation. 
The association is navigable in both directions. 



5.4.4.2 



Roles 



Name 


Definition 


theTesterObject 


This rolename provides a name allowing to navigate from an instance of Testlnvocation to the 
associated instance of TesterObject. If //is an instance of Testlnvocation, the expression 
ti. theTesterObject yields an object instance of TesterObject. 


theTestlnvocation 


This rolename provides a name allowing to navigate from an instance of TesterObject to the 
associated instance of Testlnvocation. If to is an instance of TesterObject, the expression 
to. theTestlnvocation yields an object instance of Testlnvocation. 



5.4.5 Relationship between TesterObject and MORT 



5.4.5.1 



Definition 



This relationship defines a binary association between the IOC TesterObject and the Proxy Class MORT. 
The association is navigable from the TesterObject to the MORT. 
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5.4.5.2 



Roles 



Name 



Definition 



theMORT 



This rolename provides a name allowing to navigate from an instance of TesterObject \o the associated 
instance of MORT. If to is an instance of TesterObject, the expression to.theMORT yields an object instance 
of MORT. 



5.4.6 Relationship between Testlnvocation and MORT 



5.4.6.1 



Definition 



This relationship defines an association between the IOC Testlnvocation and the IOC MORT. This association specifies 
that the latter is testing the former. 

5.4.6.2 Roles 

Instead of roles this relationship has a role name. 



5.5 



Information attributes definition 



5.5.1 Definition and legal Values 



Attribute Name 


Definition 


Legal Values 


testlnvocationld 


This attribute uniquely identifies an instance of 
a Testlnvocation within the 
TestManagementlRP. The test invocation 
identifier is assigned by the 
TestActionPerformer. When a testlnvocationld 
can be reused is outside the scope of this 
specification. 




testState 


This attribute reflects the actual test state 
(ITU-T Recommendation X.745 [5]). 


ENUM {notlnitialized, idle, initializing, 
testing, terminating, disabled} 


testOutcome 


This attribute provides information about the 

test result, as perceived by the associated TO, 

in a standardised manner. 

The information in this parameter is only valid 

after termination of the test activity. 

This information shall be present in the last test 

result notification emitted by a TO prior to its 

deletion. 


ENUM {pass, fail, inconclusive, timed-out, 
premature-termination} 
Pass indicates that the test exercise of the 
test invocation has executed correctly and 
has found no problem. 
Fail indicates that the test exercise of the 
test invocation has executed correctly and 
has found one or more problems. 
Inconclusive indicates that the TO has not 
determined if the execution is Pass or Fail. 
Timed-out indicates that the TO has 
terminated its execution because of the 
expiry of the timer (i.e., the current time - 
TestSession.sessionStartTime >= 
TesterObject.timeOut). 
Premature termination indicates that the TO 
has (a) never started execution or (b) 
terminated its execution prematurely, either 
by TestManagementlRP and its associated 
objects internal problems or in response to a 
terminateTests operation. 


supportedTOCIasses 


This attribute identifies the TO classes that are 
supported by a certain managed object 
instance whose class has inherited from 
TestActionPerformer or whose class is the 
TestActionPerformer. 


SET OF TO class name 


testActionPerformerld 


This attribute unambiguously identifies an 
instance of a TestActionPerformer. 




testerObjectld 


This attribute unambiguously identifies an 
instance of a TesterObject. 
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Attribute Name 


Definition 


Legal Values 


testlnvocationlnitiator 


It identifies the IRPManager. 


How multiple IRPManagers choose their 
identifier so that they are distinguishable is 
outside the scope of this specification. 


additionallnformation 


This attribute holds a set of additional 
information pertaining to the test. 


The semantics of this parameter are outside 
the scope of this specification 


proposedRepairActions 


This attribute suggests one or more repair 
actions if the reason for a failure is known. 


The semantics of this parameter are outside 
the scope of this specification 


actualStartTime 


This attribute specifies the time at which the TO 
will enter or has entered the test state testing. 
Before the TO enters the testing state this is an 
estimated time. After entering the testing state 
this is the actual time. Note that this is not the 
time of the invocation of the operation 
initiateTests. 


All values indicating a valid time. 


actualStopTime 


This attribute specifies the time at which the TO 
will leave or has left the test state testing. 
Before the TO leaves the testing state this is an 
estimated time. After leaving the testing state 
this is the actual time. Note that this is not the 
time of the invocation of the operation 
terminateTests. 


All values indicating a valid time later than 
the actualStartTime. 


maxTestingPhaseDuration 


This attribute specifies the maximum amount of 
time that a TO may spend in the testing state. 


All values indicating a valid amount of time. 


fileReference 


This attribute carries the reference to a file that 
contains the test result data set. 




fileExpiryDate 


This attribute carries the date and time after 
which the file, whose reference is carried by the 
fileReference attribute, may be removed. 


All values indicating a valid time. 
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6 Interface definition 

6.1 Class diagram representing interfaces 

The following diagram depicts the interfaces of the Test Management IRP with their corresponding operations and 
notifications. 



«lnterface» 
TestManagementlRPControlOperations 



+ initiateTests() 
+ terminateTestsQ 



«lnterface» 
TestManagementlRPMonitorOperations 



+ monitorTest() 



«lnformationObjectClass» 
TestActionPerformer 



«lnterface» 
TestManagementlRPNotifications 



+ notifyTestResults() 



<- 



«lnformationObjectClass» 
Teste rObject 



6.2 Generic rules 



Rule 1: 



Each operation with at least one input parameter supports a pre-condition valid_input_parameter 
which indicates that all input parameters shall be valid with regards to their information type. 
Additionally, each such operation supports an exception operation_failed_invalid_input_parameter 
which is raised when pre-condition valid_input_parameter is false. The exception has the same 
entry and exit state. 



Rule 2: 



Each operation with at least one optional input parameter supports a set of pre-conditions 
supported_optional_input_parameter_xxx where "xxx" is the name of the optional input parameter 
and the pre-condition indicates that the operation supports the named optional input parameter. 
Additionally, each such operation supports an exception 

operation_failed_unsupported_optional_input_parameter_xxx which is raised when (a) the pre- 
condition supported_optional_input_parameter_xxx is false and (b) the named optional input 
parameter is carrying information. The exception has the same entry and exit state. 



Rule 3: 



Each operation shall support a generic exception operation_failed_internal_problem that is raised 
when an internal problem occurs and that the operation cannot be completed. The exception has 
the same entry and exit state. 
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6.3 Interface testManagementlRPControlOperations 

The interface TestManagementlRPControlOperations contains the operations initiateTests and terminateTests. It must 
be implemented by every object with the ability to receive and react upon test requests, for example by every instance 
of TestActionPerformer. 

6.3.1 Operation initiateTests (M) 



6.3.1.1 



Definition 



The IRPManager uses this operation to request the IRP Agent to initiate controlled tests. A single test request may 
initiate multiple (one or more) tests. 

For each test to be initiated the managed object representing the network resource to be tested and the tester object class 
must be specified. 

The initiated tests are independent and not related to each other. This implies that independent test result notifications 
are sent for each of the tests initiated by s single initiateTests operation. 



6.3.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information Type 


Comment 


testlnvocationlnitiator 


C 


TesterObject. testlnvocationlnitiator 


This parameter identifies the IRPManager.. 


toBelnitiatedTests 


M 


SET OF SET { 

maxTestingStateDuration (0) 
toBeTestedMORT (O) 
testerObjectClass (M) 
testerObjectName (O) 
testerObjectlnitialAttributeList (0) 

} 


This sequence specifies the tests to be 
initiated. 

For each test the parameter 
maxTestingStateDuration specifies the 
timeout period of the tests to be initiated. 
One value shall indicate 'No limit'. 
toBeTestedMORT specifies the instance of 
the MORTXo be tested. If the parameter is 
absent, the MORT\s identical to the object 
instance to which the subject operation is 
directed to. 

The parameter testerObjectClass specifies 
the class of the associated tester object. 
Optionally, a name for the tester object 
instance may be specified in the parameter 
testerObjectName. 
The parameter 

testerObjectlnitialAttributeList carries some 
or all the values of the attributes of the TO 
instance responsible for the test. The 
syntax and semantics of this attribute 
value is dependent on the specific TO 
class definition and is outside the scope of 
3GPP. 
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6.3.1.3 



Output parameters 



Parameter 


Qualifier 


Matching Information 


Comment 


Name 








response 


M 


Resource self test: 


The number and the order, related to the tests to be 






SEQUENCE OF CHOICE{ 


initiated, of elements in this sequence and in the set of 






testlnitiated 


the input parameter toBelnitiatedTests shall be 






testNotlnitiated 


identical. 






} 


For a successfully instantiated test the parameter 
testlnitiated returns the test invocation identifier of the 






testlnitiated = SEQUENCE { 


test. In case the tester object name has not been 






Testlnvocation.testlnvocationld (M) 


specified in the request it shall be returned in 






testerObjectName (0) 


testerObjectName. 






} 


For a failed test instantiation the parameter 
testNotlnvoked returns the reason why the instantiation 






testNotlnitiated = 


of the test failed. 






failureReason 


Failure reasons are 
TO class is not existing 
MORT is not existing 
MORT is not available 
others 



6.3.1.4 Pre-condition 

The precondition must hold true before the operation is invoked. The pre-condition depends on the test category. 
Resource Self Test: 

For at least one of the specified tests to be instantiated the following must hold true: 
thelndicatedMORTIsExisting AND thelndicatedMORTIsAvailable AND thelndicatedTOClassIsExisting. 



Assertion Name 


Definition 


thelndicatedMORTIsExisting 


The MORT indicated by the subject operation for this test is existing 


thelndicatedMORTIsAvailable 


The MORT indicated by the subject operation for this test is available. 


thelndicatedTOClassIsExisting 


The TO class indicated by the subject operation for this test is existing. 



6.3.1.5 



Post-condition 



The post-condition must hold true after the completion of the operation: 
alllndicatedTOsInstantiated OR notAHTestsInitiated OR noTestlnitiated 



Assertion Name 


Definition 


allTestslnitiated 


All tests indicated by the subject operation were initiated successfully. 


notAIITestslnitiated 


Not all but at least one test indicated by the subject operation was initiated successfully. 


noTestlnitiated 


No test indicated by the subject operation was initiated successfully. 



6.3.1.6 



Exceptions 



Exception Name 


Definition 


operationFailedEntirely 


Condition: noTestlnitiated = TRUE 

Returned information: The response parameter is returned 

Exit state: Entry state 


operationFailedPartly 


Condition: notAIITestslnitiated = TRUE 

Returned information: The response parameter is returned 

Exit state: Entry state 
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6.3.2 Operation terminateTests (M) 



6.3.2.1 



Definition 



The IRPManager uses this operation to request the IRP Agent to terminate tests during their life time. A single 
terminateTests operation may terminate multiple (one or more) tests. 

The tests to be terminated are identified by their test invocation identifiers. The IRPManager terminating a test may be 
different from the IRPManager that initiated the test. The terminateTests operation must be invoked on the object which 
received the corresponding initiateTests operation. 



6.3.2.2 



Input parameters 



Parameter Name 


Qualifier 


Information Type 


Comment 


toBeTerminatedTests 


M 


SET OF Testlnvocation.testlnvocationld 


This parameter specifies the tests that shall 
be terminated. 



6.3.2.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


response 


M 


SEQUENCE OF CHOICE{ 


The number and the order, related to the test 






testTerminated 


invocation identifier, of elements in this sequence 






testNotTerminated 


and in the set of the input parameter 






} 


toBeTerminatedTests shall be identical. 






testTerminated = 


It specifies the test invocation ids of the tests, that 






Testlnvocation.testlnvocationld 


were successfully terminated, and the ids of the 






testNotTerminated = 


tests, that failed to be terminated successfully 






SEQUENCE! 


together with the reason for the failure. 






Testlnvocation.testlnvocationld, 


Failure reasons are 






failureReason 


test invocation id is not existing 






} 


others 



6.3.2.4 Pre-condition 

The precondition must hold true before the operation is invoked. 

alllndicatedTestlnvocationldsAreExisting OR notAHIndicatedTestlnvocationldsAreExisting 



Assertion Name 


Definition 


alllndicatedTestlnvocationldsAreExisting 


All test invocation identifiers specified by the subject operation are existing. 


notAlllndicatedTestlnvocationldsAreExisting 


Not all but at least one test invocation identifier specified by the subject 
operation is existing. 



6.3.2.5 Post-condition 

The post-condition must hold true after the completion of the operation. 

alllndicatedTestsTerminated OR notAHIndicatedTestsTerminated OR noIndicatedTestTerminated 



Assertion Name 


Definition 


alllndicatedTestsTerminated 


All tests indicated in the subject operation were terminated successfully. 


notAlllndicatedTestsTerminated 


Not all but at least one test indicated in the subject operation aaws terminated 
successfully 


noIndicatedTestTerminated 


No test indicated in the subject operation aaws terminated successfully 
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6.3.2.6 



Exceptions 



Exception Name 


Definition 


operationFailedEntirely 


Condition: nolndicatedTestTerminated = TRUE 

Returned information: The response parameter is returned 

Exit state: Entry state 


operationFailedPartly 


Condition: notAlllndicatedTestlnvocationldsAreExisting = TRUE OR 
notAlllndicatedTestsTerminated = TRUE 
Returned information: The response parameter is returned 
Exit state: Entry state 
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6.4 Interface TestManagementlRPMonitorOperations 

The interface TestManagementlRPMonitorOperations contains the operation monitorTest. It has a realisation 
relationship with the IOC TestActionPerformer. 

6.4. 1 Operation monitorTest (M) 



6.4.1.1 



Definition 



IRPManager shall be able to retrieve information about the test as observed by the TO during the test execution by 
reading the relevant attributes of the TO associated to the test. Also after the test execution the manager shall be able to 
read these attributes as long as the TO exists. Attributes conveying information about the test execution are testState and 
testOutcome. Depending on the specific test category specific TO or the VSE TO other attributes may also contain 
information about the test execution. In this case the subject operation may also allow to read the values of these 
attributes. 



6.4.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information Type 


Comment 


toBeMonitoredTO 


M 


tOlnstance 


This parameter specifies the instance of the tester object, 
whose attribute values of testState, testOutcome and 
other attributes shall be retrieved. 


toBeMonitoredAttributes 


C 


SET OF attributeldentifier 


This parameter specifies the identifiers of the attributes 
whose values shall be read. 



6.4.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


monitoredAttribute Values 


M 


SET{ 

TesterObject.testState (M) 
TesterObject.testOutcome (M) 
other attributes (0) 

} 


This parameter shall be returned if all attributes 
were read successfully and may be returned, if 
at least one attribute was read successfully. 
The values to be returned are those prevalent 
at the time of the reception of the subject 
operation. 


error 


M 


failureReason 


This parameter shall be returned if the 

specified tester object instance is not existing 

or, in case the tester object instance is existing, 

at least one attribute could not be read, i. e. if 

operationFailedEntirely = TRUE 

OR 

operationFailedPartly = TRUE 

The parameter returns the failure reason. 



6.4.1.4 Pre-condition 

The precondition must hold true before the operation is invoked. 
indicatedTOInstancelsExisting 



Assertion Name 


Definition 


toBeMonitoredTOIsExisting 


The TO instance indicated by the subject operation is existing. 
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6.4.1.5 Post-condition 

The post-condition must hold true after the completion of the operation. 

allAttributeValuesRead OR notAHAttributeValuesRead OR noAttributeValueRead 



Assertion Name 


Definition 


allAttributeValuesRead 


All attributes of the TO indicated by the subject operation were read successfully. 


notAIIAttributeValuesRead 


Not all but at least one attribute of the TO indicated by the subject operation were read 
successfully. 


noAttributeValueRead 


No attribute of the TO indicated by the subject operation was read successfully. 



6.4.1.6 



Exception 



Exception Name 


Definition 


operationFailedEntirely 


Condition: toBeMonitoredTOIsExisting = FALSE OR noAttributeValueRead = TRUE 
Returned information: The error parameter returns the object identifier of the TO that does 
not exist or the reasons, why the attributes could not be read 
Exit state: Entry state 


operationFailedPartly 


Condition: toBeMonitoredTOIsExisting = TRUE AND notAIIAttributeValuesRead = TRUE 

Returned information: The error parameter returns the reason why an attribute could not be 

read. The attribute that could be read my be returned in the parameter error or the parameter 

attributeList 

Exit state: Entry state 
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6.5 Interface TestManagementlRPNotifications 

6.5.1 Notification notifyTestResults (M) 
6.5.1.1 Definition 

Test results are made available to the IRPManager by one or more notifications notifyTestResults emitted by the TO that 
is related to the test invocation. 

Depending on the nature of the test and the specification of the TO behaviour, the TO may need to convey to the 
IRPManager a test result data set. There are two ways to convey this kind of information. One way is to use the 
parameter additionallnformation of the notification. In this case, the file Reference and file Expiry Date shall contain no 
information or be absent. The other way is to use a file to capture the test result data set. In this case, the 
additionallnformation parameter may contain no information or be absent and the file Reference and file Expiry Date 
shall be present. The file that captures the test result data set shall contain VSE attributes and other 3 GPP attributes such 
as testerObjectClass, testOutcome, etc. 

The use of the additionallnformation parameter or a file to capture the test result data set is specified by the class 
specification of the TO. 

In case the TO uses additionallnformation (and not a file) to capture the test result data set, that TO may emit this 
notification to transfer intermediate (non-final) test results. In this kind of notifications, the testOutcome parameter shall 
be absent. The TO should emit at least one more notification regarding the subject test invocation in the future. The last 
notification pertaining to a particular test invocation shall be indicated by including the testOutcome parameter in the 
notification. 

In the case the TO uses a file to capture the test result data set, that TO shall not issue any notifications to transfer 
intermediate test results. The TO may capture the non-final test results in the file used to capture the final test result data 
set. 

The events triggering the emission of test result notifications depend on the specific test. They shall be specified by the 
TO that is actually instantiated, i.e. either by the test category specific TO or the VSE TO. Some generic triggering 
events are included in this specification. It is expected that vendors specify more triggering events. 
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Parameter Name 


Qualifier 


Matching Information 


Comment 


objectClass 


M, Y 


TesterObject. objectClass 


Notification header - see [1]. It shall carry the 
TO class name. 


objectlnstance 


M, Y 


TesterObject. objectlnstance 


Notification header - see [1]. It shall carry the 
DN of the TO.. 


notificationld 


0, N 


-- 


Notification header - see [1]. 


eventTime 


M, Y 


-- 


Notification header - see [1]. 


systemDN 


C,Y 


-- 


Notification header - see [1]. 


notificationType 


M, Y 


"notifyTestResults" 


Notification header - see [1]. 


testlnvocationld 


0, N 


Testlnvocation.testlnvocationld 




testlnvocationlnitiator 


C, Y 


TesterObject.testlnvocationlnitiator 




testOutcome 


0, N 
(see note) 


TesterObject. testOutcome 


It shall be included only in the last notification 
emitted by a TO. In this way the TO indicates 
that it is sending no more notifications. 


mORT 


0, N 


TesterObject.theMORT 


It identifies the object instance of the MORT 
that was subject to the test. 


proposedRepairActions 


0, N 


TesterObject. proposedRepairActions 




additionallnformation 


0, N 
(see note) 


TesterObject. additionallnformation 


It allows the inclusion of any additional 
information in the notification. As such, it may 
carry a test result data set. 
The exact semantics of this parameter is 
outside the scope of this specification. 
This parameter may contain no information or 
be absent, if the test results are captured in a 
file. It may be present if the test results are not 
captured in a file. 


fileReference 


M, N 
(see note) 


TesterObject.fileReference 


It shall contain no information or be absent if 
there is no test result captured in a file. It shall 
contain information if the test results are 
captured in a file. 


fileExpiryDate 


M, N 
(see note) 


TesterObject.fileExpiryDate 


It shall contain no information or be absent if 
fileReference carries no information or absent. 
Otherwise, it shall contain a valid future date 
and time. 


NOTE: As for the correct interpretation of this qualifier refer to the comment column. 



6.5.1 .2 Triggering Events for the Resource Self Test 

For the resource self test the events triggering the emission of test result notifications are: 

• Termination of the test execution. 

The resource self test may be terminated explicitly by a test termination request. The events triggering an implicit 
termination are: 

• Fulfilment of the conditions for a successful termination of the test. 

• Fulfilment of the conditions for a premature termination of the test. 

• Occurrence of an error situation. 
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6.5.1.2.1 



From-State 



testTerminateRequestReceived OR testCompleted OR prematureTermination OR testTimedOut OR 
errorSituationOccured. 



Assertion Name 


Definition 


testTerminateRequestRe 
ceived 


The object with the ability to receive and react upon test requests has received a test termination 
request (see note). 


testCompleted 


The predefined conditions for a successful completion of the test are fulfilled (see note). 


prematureTermination 


The predefined conditions for a premature termination of the test are fulfilled (see note). 


errorSituationOccured 


An error situation has occurred during the test execution and the tester object has aborted the 
test invocation (see note). 


NOTE: The conditions to satisfy this trigger are related to the VSE TO definition and therefore, their specifications are 
outside the scope of 3GPP. 



6.5.1.2.2 

testTerminated 



To-State 



Assertion Name 


Definition 


testTerminated 


The test has been terminated successfully. 
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Annex A (informative): 
Change history 



Change history 


Date 


TSG# 


TSG Doc. 


CR 


Rev 


Subject/Comment 


Cat 


Old 


New 


Jun 2002 


SA 16 


SP-020328 


-- 


-- 


Submitted to TSG SA #16 for Information 


-- 


1.0.0 




Sep 2002 


SA 17 


SP-020457 


-- 


-- 


Submitted to TSG SA #1 7 for Approval 


-- 


2.0.0 


5.0.0 


Dec 2002 


-- 


-- 


-- 


-- 


Cosmetics 


- 


5.0.0 


5.0.1 


Jun 2004 


SA 24 


SP-040243 


0001 


-- 


Add missing parameter to the operation initiateTests 


F 


5.0.1 


5.1.0 


Sep 2004 


SA_25 


SP-040541 


— 


— 


Automatic upgrade to Rel- 6 (no CR) as per request in 
SP-040541 SA5_presentation_SA_25.ppt (slide 17) 


— 


5.1.0 


6.0.0 


Jun 2005 


SA 28 


SP-050289 


0002 




Apply Generic System Context 


F 


6.0.0 


6.1.0 


Mar 2006 


SA 31 


SP-060089 


0003 


-- 


Update mapping table to use defined filter qualifier 


F 


6.1.0 


6.2.0 


Sep 2007 


SA 37 


SP-070606 


0004 


-- 


Correct granularity of maxTestingStateDuration 


F 


6.2.0 


6.3.0 


Mar 2008 


SP-39 


SP-080056 


0007 


- 


Do not force Solution Sets to use toBeMonitoredAttributes 


F 


6.3.0 


6.4.0 
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